home *** CD-ROM | disk | FTP | other *** search
/ Cinema Studio: Frank Herrmann / Cinema Studio - Frank Herrmann.iso / tools / pbm / manuals / wrjpgcom.man < prev    next >
Text File  |  1994-09-28  |  3KB  |  133 lines
  1.  
  2.  
  3.  
  4.      WRJPGCOM(1)          AMIGA (30 August 1994)           WRJPGCOM(1)
  5.  
  6.  
  7.  
  8.      NAME
  9.           wrjpgcom - insert text comments into a JPEG file
  10.  
  11.      SYNOPSIS
  12.           wrjpgcom [ -replace ] [ -comment text ] [ -cfile name ] [
  13.           filename ]
  14.  
  15.      DESCRIPTION
  16.           wrjpgcom reads the named JPEG/JFIF file, or the standard
  17.           input if no file is named, and generates a new JPEG/JFIF
  18.           file on standard output.  A comment block is added to the
  19.           file.
  20.  
  21.           The JPEG standard allows "comment" (COM) blocks to occur
  22.           within a JPEG file.  Although the standard doesn't actually
  23.           define what COM blocks are for, they are widely used to hold
  24.           user-supplied text strings.  This lets you add annotations,
  25.           titles, index terms, etc to your JPEG files, and later
  26.           retrieve them as text.  COM blocks do not interfere with the
  27.           image stored in the JPEG file.  The maximum size of a COM
  28.           block is 64K, but you can have as many of them as you like
  29.           in one JPEG file.
  30.  
  31.           wrjpgcom adds a COM block, containing text you provide, to a
  32.           JPEG file.  Ordinarily, the COM block is added after any
  33.           existing COM blocks; but you can delete the old COM blocks
  34.           if you wish.
  35.  
  36.      OPTIONS
  37.           Switch names may be abbreviated, and are not case sensitive.
  38.  
  39.           -replace
  40.                Delete any existing COM blocks from the file.
  41.  
  42.           -comment text
  43.                Supply text for new COM block on command line.
  44.  
  45.           -cfile name
  46.                Read text for new COM block from named file.
  47.  
  48.           If you have only one line of comment text to add, you can
  49.           provide it on the command line with -comment.  The comment
  50.           text must be surrounded with quotes so that it is treated as
  51.           a single argument.  Longer comments can be read from a text
  52.           file.
  53.  
  54.           If you give neither -comment nor -cfile, then wrjpgcom will
  55.           read the comment text from standard input.  (In this case an
  56.           input image file name MUST be supplied, so that the source
  57.           JPEG file comes from somewhere else.)  You can enter
  58.           multiple lines, up to 64KB worth.  Type an end-of-file
  59.           indicator (usually control-D) to terminate the comment text
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 9/28/94)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      WRJPGCOM(1)          AMIGA (30 August 1994)           WRJPGCOM(1)
  71.  
  72.  
  73.  
  74.           entry.
  75.  
  76.           wrjpgcom will not add a COM block if the provided comment
  77.           string is empty.  Therefore -replace -comment "" can be used
  78.           to delete all COM blocks from a file.
  79.  
  80.      EXAMPLES
  81.           Add a short comment to in.jpg, producing out.jpg:
  82.  
  83.                wrjpgcom -c "View of my back yard" in.jpg > out.jpg
  84.  
  85.           Attach a long comment previously stored in comment.txt:
  86.  
  87.                wrjpgcom in.jpg < comment.txt > out.jpg
  88.  
  89.           or equivalently
  90.  
  91.                wrjpgcom -cfile comment.txt < in.jpg > out.jpg
  92.  
  93.      SEE ALSO
  94.           cjpeg(1), djpeg(1), rdjpgcom(1)
  95.  
  96.      AUTHOR
  97.           Independent JPEG Group
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 9/28/94)
  130.  
  131.  
  132.  
  133.